package xx.services.entity.inter;

import javax.ws.rs.FormParam;
import javax.ws.rs.PathParam;

/**
 * 实体图片服务接口
 * 
 * @Path (Constants.RESTFUL_ROOT_PATH + "/picture")
 * @author chenx
 */
public interface IPictureInterface
{
    /**
     * 修改图片{picture_id}的名称、描述等。
     * 
     * @PUT
     * @Path ("/{picture_id}")
     * @param pictureId-@PathParam("picture_id")
     *            图片ID
     * @param name-@FormParam("name")
     *            图片名称
     * @param description-@FormParam("description")
     *            图片描述
     * @return 新图片实体
     * @author dengjinye,2010-10-29
     */
    public String updatePicture(@PathParam("picture_id")
    long pictureId, @FormParam("name")
    String name, @FormParam("description")
    String description);

    /**
     * 删除图片{picture_id}集。
     * 
     * @DELETE
     * @Path ("/{picture_id}")
     * @param pictureId-@PathParam("picture_id")
     *            图片ID，多个图片ID用“_”隔开
     * @return
     * @author dengjinye,2010-10-29
     */
    public String deletePicture(@PathParam("picture_id")
    String pictureId);
}
